home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Sound / GSMToast / man / gsm_option.3.txt < prev    next >
Encoding:
Text File  |  1996-04-28  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. GSM_OPTION(3)          C Library Functions          GSM_OPTION(3)
  5.  
  6.  
  7.  
  8. NAME
  9.      gsm_option - customizing the GSM 06.10 implementation
  10.  
  11. SYNOPSIS
  12.      #include "gsm.h"
  13.  
  14.      int gsm_option(handle, option, valueP);
  15.      gsm handle;
  16.      int option;
  17.      int * valueP;
  18.  
  19. DESCRIPTION
  20.      The gsm library is an implementation of the final draft  GSM
  21.      06.10  standard  for  full-rate  speech transcoding, a lossy
  22.      speech compression algorithm.
  23.  
  24.      The gsm_option() function can be used to set and query vari-
  25.      ous  options  or  flags  that are not needed for regular GSM
  26.      06.10 encoding or decoding, but might be of interest in spe-
  27.      cial cases.
  28.  
  29.      The second argument to gsm_option specifies  what  parameter
  30.      should  be changed or queried.  The third argument is either
  31.      a null pointer, in which case  the  current  value  of  that
  32.      parameter is returned; or it is a pointer to an integer con-
  33.      taining the value you want to set, in which case the  previ-
  34.      ous value will be returned.
  35.  
  36.      The following options are currently defined:
  37.  
  38.      GSM_OPT_VERBOSE Verbosity level.
  39.           This option is only supported if the library  was  com-
  40.           piled  with  debugging  turned  on,  and may be used by
  41.           developers of compression algorithms to aid debugging.
  42.           The verbosity level can be changed at any  time  during
  43.           encoding or decoding.
  44.  
  45.      GSM_OPT_FAST Faster compression algorithm.
  46.           This implementation offers  a  not  strictly  standard-
  47.           compliant,  but  faster  compression  algorithm that is
  48.           compatible with the regular method and does not notica-
  49.           bly degrade audio quality.
  50.           The value passed to
  51.                gsm_option(handle, GSM_OPT_FAST, & value)
  52.           functions as a boolean flag; if it is zero, the regular
  53.           algorithm will be used, if not, the faster version will
  54.           be used.
  55.           The availability of this option depends on the hardware
  56.           used; if it is not available, gsm_option will return -1
  57.           on an attempt to set or query it.
  58.           This option can be set  any  time  during  encoding  or
  59.           decoding.
  60.  
  61.  
  62.  
  63. SunOS 5.4                 Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GSM_OPTION(3)          C Library Functions          GSM_OPTION(3)
  71.  
  72.  
  73.  
  74.      GSM_OPT_LTP_CUT Enable, disable, or query  the  LTP  cut-off
  75.      optimization.
  76.           During encoding, the search for the long-term  correla-
  77.           tion  lag  forms  the  bottleneck of the algorithm. The
  78.           ltp-cut option enables an approximation that disregards
  79.           most of the samples for purposes of finding that corre-
  80.           lation, and hence speeds up the encoding at a noticable
  81.           loss in quality.
  82.           The value passed to
  83.                gsm_option(handle, GSM_OPT_LTP_CUT, & value)
  84.           turns the optimization on if nonzero, and off if zero.
  85.           This option can be set  any  time  during  encoding  or
  86.           decoding;  it  will  only affect the encoding pass, not
  87.           the decoding.
  88.  
  89. RETURN VALUE
  90.      gsm_option() returns -1 if an option is not  supported,  the
  91.      previous value of the option otherwise.
  92.  
  93. BUGS
  94.      Please  direct  bug  reports  to  jutta@cs.tu-berlin.de  and
  95.      cabo@cs.tu-berlin.de.
  96.  
  97. SEE ALSO
  98.      toast(1), gsm(3), gsm_explode(3), gsm_print(3)
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. SunOS 5.4                 Last change:                          2
  130.  
  131.  
  132.  
  133.